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1.0 INTRODUCTION 

This document describes the differences between BASIC/RT-11 VO1B_ and 
BASIC-11/RT-11 V2. It also lists some restrictions you should be 
aware of when uSing BASIC-ii/RT-ii VZ. This document describes’ the 
procedure you should follow to install BASIC-11 on your RT-11 V03 
system. Lastly, it shows how to use the program SUCVT to convert 
BASIC/RT-11 VO1B programs to a format suitable for BASIC-l1/RT-1ll V2. 


The following documentation conventions are used throughout this 
manual: 


1. Square brackets [ ] enclose optional items. 
2. Braces {} enclose items from which you must choose only one. 


3. Upper case letters represent keywords that you must type as 
shown. 


4. Lower case letters represent variables for which you supply 
values. 


5. Ellipses ... indicate that the immediately preceding item 
can be repeated. 


6. User input is underlined where necessary to distinguish it 
from computer printout. 


7. ‘The abbreviation "expr" represents expression. 


8. The symbol represents a carriage return. 


2.0 CHANGES FROM BASIC/RT-11 VO1B 
This section summarizes the differences between BASIC/RT-11 V0O1B_ and 


BASIC-11/RT-11 V2. You can find more information on BASIC-11/RT-11 V2 
in the following two documents: 


BASIC-11 Language Reference Manual 
Order No. DEC-1LI-LIBBB-A-D 
BASIC-11/RT-11 User's Guide 


Order No. DEC-11-LIBUA-A-D 


For more information on the RT-11 V03 operating system, consult’ the 
following guide: 


RT-11 Documentation Directory 
Order No. DEC-11-ORDDB-A-D 


Table 1 lists the new features of BASIC-11/RT-11 V2. 
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Table l 
New Features of BASIC-11/RT-1l V2 


Integer Data Type = 


Double Precision Data Type 


COMMON 

DIM# 

KILL 

LINPUT 

NAME 

ON GOTO 

ON GOSUB 

ON THEN 
PRINT USING 
RESET 


Statements 


ABORT 
CTRLC 
LOG1O 
PI 
RCTRLC 
RCTRLO 
SYS 


TTIVvVCERT 


a 2 AW 


Functions 


APPEND 
BYE 
COMPILE 


Commands 


CTRL/S 


Some statements, functions, and commands are not entirely new in 
BASIC-11/RT-11 V2, but have syntactical or functional differences from 
their counterparts in BASIC/RT-11 V01B. Tables 2, 3, and 4 list both 
the old and new statements, functions, and commands. The tables also 
provide a brief explanation of the changes. 


VO1B 


V2 


VO1B 
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Table 2 
Changes in Statements from 
BASIC/RT-11 V01B to BASIC-11/RT-11 V2 


| Version | Statement | 


Pine AaimAA 


. 
1e@ name qprartgumenc 


list)] 

CALL ["] routine name["] [(argument list) 

In V2, the quotation marks delimiting the routine names 
are optional. 

CHAIN “string” LINE number. 

CHAIN string [LINE expression] 


In V2, the line number’ specification can be an 
expression. 


| 


Cin J 
CLOSE [ [#]expr1, [#] expr2, [i] expr3,...] 


In V2, the pound sign (#) is optional. You can specify 
more than one file, and the file specification can be 


an expression. The VFn syntax is no longer permitted. 


DATA list 
DATA list 
In V2, unquoted strings are permitted. The 


statement must be .the last statement 
multi-statement line. 


DEF FNletter (varl[,var2,...var5] )=expression 


$ 
DEF FNletter | } (varl[,var2,...,var5] )=expression 
% 


In V2, if the function returns a string, the function 
name (FNlietter) must end with a dollar sign ($). If 
the function returns an integer, the function name must 
end with a percent sign (%). 


THEN 
IF relational expression line number 


GO TO 


( THEN 
IF END #¢n line number 


GO TO 


(continued on next page) 
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Table 2 (Cont.) 
Changes in Statements from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 V2 


THEN statement 
IF relational expression {THEN line number 


GO TO line number 


THEN statement 
IF END #expr THEN line number 
GO TO line number 


In V2, the THEN keyword can be followed by a_ statement 
as well as by a line number. 


INPUT variablel[,variable2,...] 


INPUT [#expr,] variablel[,variable2,...] 


In V2, you can type more than one string on a line. 


INPUT #expr: variablel[,variable2,...] 


INPUT [#expr,] variablel[,variable2,...] 


DIGITAL recommends that you follow the expression by a 
comma (,) rather than by a colon (:), even though the 
colon is still permitted. 


V01B [LET] variable=expression 
(| LET] VFn(i)=expression 
v2 [LET] variable=expression 
In V2, the VF format is not permitted. 


INPUT 
V01B OPEN file ||FOR [(b)] AS FILE #digit [DOUBLE BUF] 


OUTPUT 


INPUT 


OPEN file FOR { OUTPUT 


[eos FILE VFdigit (dimension)=string length 


FOR I 
OPEN string [eer coreont| AS FILE [+] expr [pousze Bur] 


V2 
| necorpsrze expr] [ move expr | | Frnesrze expr | 


In V2, the file specification can be any string 
expression. The pound sign (#) is optional. Specify a 
file size by using the FILESIZE keyword. The VF format 
is not permitted. 


(continued on next page) 
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Table 2 (Cont.) 
Changes in Statements from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 V2 


| Version | Statement | 


VO1B OVERLAY "file descriptor" 
v2 | OVERLAY string [LINE expression] 
In V2, the line number specification can be an 
' expression. 
v2 PRINT [#expr,] [list] 


DIGITAL recommends that you follow the expression by a 
comma (,) rather than by a colon (:), even though the 


| 
VO1B PRINT #expr: list 
colon is still permitted. 


VO1B | RANDOMIZE 


V2 RANDOMIZE 
number each time the statement is executed. 


VO0O1B REM comment 


In V2, the random number generator starts at a new 
V2 REM comment 


| | In V2, you can terminate a comment by a backslash (\). | 


Table 3 
Changes in Functions from 
BASIC/RT-11 V01B to BASIC-11/RT-11 V2 


Version Function 


VO1B ASC (string) 
V2 ASC (string) 


In V2, this function returns an 8-bit (rather than 
7-bit) value. 


BIN {(Jstring DJ 


(continued on next page) 
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Table 3 (Cont.) 
Changes in Functions from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 V2 


Version Function 


v2 BIN (string) 


In V2, the 
required. 


parentheses delimiting the argument are 
VO1B CHRS (expr ) 
V2 CHRS (expr ) 
In V2, this function accepts an 8-bit (rather than 
7-bit) value. 
VO1B OcT [(Jstring[)] 
v2 OCT (string) 
In V2, the parentheses delimiting the argument are 
required. 
STRS (expr ) 


STRS (expr ) 


In V2, this function can return more than six digits 
(with double precision arithmetic). 


Table 4 
Changes in Commands from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 v2 


Version Command 


LIST{NH] 

LISTENH}] line number 

LISTE{NHJ-line number 

LISTENHJ line number - [END] 
LISTE{NH) line number - line number 


LIST[NH] [line specificationl,line specification2,...] 


In V2, you can list more than one line range 
specification. The END specification is no longer 
allowed. The other V01B forms of the command are still 
valid in V2. 


(continued on next page) 
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Table 4 (Cont.) 
Changes in Commands from 
BASIC/RT-11 V01B to BASIC-11/RT-11 V2 


| Version | Command | 


NEW "program name". 
OLD "file specification" | 


RENAME “program name" 
REPLACE "file specification” 
SAVE "file specification" 


V2 


| 
NEW [program name] 
OLD [file specification] 
RENAME program name 
1 REPLACE file specification 
SAVE [file specification] 
In V2, these. commands must not contain quotation marks 
that delimit the file specifications. 
VOI1B ~. RUN 
| RUNNH 
v2 RUN {NHJ 
RUN [NHJ file specification 
In V2, you can include a file specification in the RUN 
and RUNNH commands. 
VO1B ~CTRL/C 
¥2 


In. V2, CTRL/C ‘returns control to: BASIC (in VO1B, it 
returned control ‘to the RT-1ll monitor). CTRL/C also 


prints the line number of the line that was executing 
when it interrupted the program. 


Table 5 lists changes in . miscellaneous features from BASIC/RT-11 V01B 
to BASIC-11/RT-11 V2. 


BASIC~11/RT-11 INSTALLATION GUIDE 


Table 5 
Changes in Miscellaneous Features from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 v2 


Maximum line 
number 


In V2, the maximum line number is 32767 (in 
VO1B, it was 65532). 


String concate- In V2, the string concatenation operator 
nation operator can be either the ampersand (&) or the plus 
sign (+) (in VO1B it was the ampersand). 


Virtual arrays In V2, virtual arrays are like arrays in 
memory (except that they are not zeroed at 
run time); they do not have special 
variable names. Virtual arrays can have 
one or two subscripts (V01B allowed just 
one subscript). The string length can have 
any value between 1 and 255; it does not 
have to be a power of 2. The default 
string length is 16 (in VO1B, it was 32). 


Terminal width In V2, the terminal width can be set from l 
to 255 characters. See the BASIC-11/RT-11 
User's Guide for a description of the 
TTYSET function. 


Closing files In V2, files are closed by the CLOSE or END 
statement (or by execution of the last line 
of the program) but are left open by the 
STOP statement. Any open output files are 
deleted by the RUN, SCR, OLD, and NEW 
commands. (In V0O1B, STOP, RUN, SCR, OLD, 
and NEW closed files.) 


Deleting a character In V2, the DELETE (or RUBOUT) key deletes a 
character; the backarrow (or underscore) 
key does not. (Both DELETE and backarrow 
were valid in VO1B.) 


Deleting a line In V2, the CTRL/U command deletes a _ line; 
the ESCAPE (or ALTMODE) key does not. 
(Both CTRL/U and ESCAPE were valid in 
VO1B.) 


Lower case In V2, lower case keywords and variable 
names are always converted to upper case. 
Lower case string constants and remarks are 
permitted. 


(continued on next page) 


BASIC-11/RT-11 INSTALLATION GUIDE 


Table 5 (Cont.) 
Changes in Miscellaneous Features from 
BASIC/RT-11 VO1B to BASIC-11/RT-11 V2 


Feature 


| 
Arithmetic hardware BASIC~-11/RT-11 V2 supports’ the following 
support hardware (VO1B also supported this 
hardware) : 


EAE KE11-A and KE11-B 
Extended Arithmetic Element 


Extended Instruction Set 


FPU FP11-A, FP11-B, and FP11-C 
Floating Point Unit 


EIS KE11-E 
Support of the following hardware is new in 
V2: 

FIS KE11-F 

Floating Point Instruction Set 

KEV-1ii 

Extended Arithmetic Element 


CALL interface In V2, the CALL interface is similar to the 
FORTRAN IV CALL interface. Note that 
‘arrays are stored with the second subscript 


varying faster; they are stored 
independently of the scalar with the same 
name. Manv intarnal tahla  farmsta ana 


ieee 4 mec wwe 44s ne eae od ew & A War inet 


offsets have changed. 


BASIC-11/RT-11 User's Guide for a complete 


description of the CALL interface. 


3.0 RESTRICTIONS IN BASIC-11/RT-11 V2 


BASIC-11/RT-1l users should always keep abreast of BASIC-related 
notices published by DIGITAL. Changes published in the Software 
Performance Summary need be made only once and should be made 
immediately. Changes published in the Digital Software News should be 
Made aS soon as possible to systems in use. The following sections 
summarize the restrictions in BASIC-11/RT-1l1 V2 of which you should be 
aware. 


3.1 Floating Point Operations 


Since whole floating point numbers are not stored as_ integers, 
execution of floating point operations can be slower than in VO1B, in 
certain circumstances. To avoid this problem, convert the data from 
floating point to integer by specifying the percent sign (%) wherever 
possible. 
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3.2 READ Statement 


Since a list created by a data statement is stored in ASCII format 
(rather than in a binary internal format), the READ statement requires 
additional time to translate data items. 


3.3 REM Statement 


A REM statement terminated by a backslash (\) gets longer by one space 
each time a program containing it is saved by the SAVE command. If a 
program containing such a line is called and saved (with the OLD and 
SAVE commands) several times, the line can become too long for BASIC 
to handle properly. Use the SUB command to delete the extra spaces 
before the line gets too long. 


3.4 Subscripts 


BASIC calculates subscripts by performing an INT function rather than 
by using true truncation. This method of calculating subscripts 
causes no problems with positive subscripts. It also causes no 
difficulty with subscripts of -1l or less, since BASIC does not support 
negative subscripts. However, BASIC does give an error (?SUBSCRIPT 
OUT OF BOUNDS) for A(-.5). 


3.5 GOSUB Statement 


An immediate mode GOSUB to a routine that has an INPUT or LINPUT 
statement can crash BASIC, under certain circumstances. This can 
occur because BASIC uses the same area of memory to process’ both 
immediate mode statements and terminal input. When BASIC returns 
control to the line with the immediate mode GOSUB statement, that line 
has been overwritten by the terminal input (from the INPUT or LINPUT 
statement). To avoid this problem, use an immediate mode GOTO 
statement in place of the GOSUB' statement. This causes BASIC to 
execute the subroutine, print a warning, and then print the READY 
message. 


3.6 COMPILE Command > 


The COMPILE command generates a file with a .BAC file type under BASIC 
with single precision arithmetic. Similarly, it generates a file with 
a .BAX file type under BASIC with double precision arithmetic. If you 
use an OLD, RUN, or CHAIN command to call a .BAC file under double 
precision BASIC or a .BAX file under single precision BASIC, BASIC can 
crash. You must explicitly specify the wrong file type to create this 
problem. BASIC executes properly when you rely on default file types. 


3.7 File Types 


When you call a file (with an OLD, RUN, or CHAIN command), BASIC looks 
first for a compiled image, and then for a .BAS image. If, for 
example, you specify OLD xX.BAC and X. BAC does not exist, 
BASIC-11/RT-11 V2 continues to search for the .BAS file. 
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3.8 Device Handlers 

If a BASIC program that contains an array resides on a device whose 
handler is not resident, references you make to that device (with the 
OPEN statement, or the CHAIN command, for example) can cause _ the 


system to crash. Be sure to load the appropriate device handler to 
avoid this problem. 


3.9 OPEN Statement 
When BASIC opens an integer virtual array, and the subscript you 


specify in the DIM# statement is 1 or 2 less than a mhet pte of 256, 
BASIC creates a file that is one block too long. 


3.10 Reena a String 

If you place a null string as the last item in a DATA statement or an 
input line, indicate’ it by two adjacent quotation marks. The 
following example shows two null strings: one is indicated by two 
adjacent commas, and the other by two adjacent quotation marks. . 


10 TATA SeARCy4Ss sTEFs"*" 


4.0 INSTALLATION PROCEDURE 


The BASIC-11/RT-11 V2 software kit contains three running versions of 
BASIC: 


1. BASIC.SAV 

2. BAS8K.SAV 

3. BASICD.SAV 
The BASIC.SAV version includes all the optional features except the 
CALL statement. It is overlaid (it has overlay type 3) and does not 
include support for arithmetic hardware. Its base address is 1000. 
The BAS8K.SAV version can execute in 8K words of memory. It should 
only be used for 8K RT-11 systems. It does not include the following 
optional features: 

1. PRINT USING statement 

Ze SUB command 

3. CALL statement 

4. RESEQ command 

5. Long error messages 
BAS8K is overlaid (it has overlay type 5) and does not include support 
for arithmetic hardware. In addition, BAS8K has a base address of 
700. 
BASICD.SAV has the same features and overlay type as BASIC.SAV. It 


supports double precision floating point arithmetic and has a base 
address of 1200. 


ll 
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4.1 Linking BASIC 


If BASIC.SAV, BASICD.SAV, or BAS8K.SAV is Suitable for your 
application, you do not need to relink BASIC. However, you can link 
BASIC to make any of these changes: 


l. Change the overlay type 

2. Add support for arithmetic hardware 

3. Add CALL support and assembly language routines 
4. Add or remove any optional features 


To link BASIC, you must run the program SUCNFG.BAS. This program asks 
you questions about BASIC's features and optional support. Then it 
creates an indirect command file that you must execute. This indirect 
file links BASIC according to the instructions you supplied to SUCNFG. 
The indirect file creates an executable version of BASIC (with any 
name you specify) that is tailored to.your requirements. 


Read Sections 4.2 and 4.3 to learn how to use the dialogue program, 
SUCNFG. Then read Section 4.4, which describes how to transfer the 
necessary files for linking BASIC from the software kit to your 
system. 


4.2 Using the Dialogue Program 


To invoke the dialogue program, you must first run BASIC. Then run 
SUCNFG: 


.R BASIC GED 
BASIC-11/RT-11 VO2-02 
OPTIONAL FUNCTIONS (ALLy NONE OR INDIVIDUAL)? GED 


REALY 
RUN SUCNFG QED 
BASIC-1i1/7RT-11 VO2 Confisuration Frosram 


Tyre “?Plret:" after any rromet for HELP. 


«SAV and .COM file name (default is BASIC); 


When the dialogue prompts you for a .SAV and .COM file name, enter the 
name of the BASIC version you want to create. If you type only the 
RETURN key, the new version of BASIC is called BASIC.SAV. Note that 
if the new version is called BASIC.SAV, it replaces the version you 
are currently running. The listing shown in Figure 1 contains all the 
questions in the dialogue program, along with brief explanations. 
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*SAV and .COM file name (default is BASIC)? 


Enter the name in 6 or less characters for the name to be 
siven to the .SAV imase of BASIC and the indirect file 
to be used to build BASIC. 


Bo vou want @ mar? CY or Ns default is Nd3 


Tyre Y for ves or N for no. If the answer 
is Yr the next auestion will esk for &@ name. 


«MAP name (default is same as .SAV name)? 
Enter “ret> or ene legal file name, 
Backsround or Foresround ? (B or Fs default is 5B)? 


BK creates @ «SAV imase to he run in the backsround. F creates 
@ REL image to be run in the foresround. , 


To gou want FRINT USING? CY or Ns default is Y? 
Y includes the FRINT USING ortiony N does mot, 
Yo vou want CALL surreort? CY or N$ default is N)3 


Y includes CALL surrorts N does not. If CALL surrort is 
included the next auestion will handle the modules to 
be used with CALL in this BASIC. 


Enter module mames Cone rer lined? 


On each line enter the name of 2&2 module to be included. Include your 
modified BSCLI,s your subroutiness and BSCLLEB,y if it is needed. | 

When all the modules have been entered» ture <ret> slone,. 

For more information, release see the documentation om CALL. 


Single or Double frecision math? ¢(S or Ds default is S$)? 


S creates a BASIC that surrorts the 2-word floating roint 
rerresentstion. Tt creates a BASIC that surrorts the 4-word 
floating roint rerresentstion. 


Arithmetic hardware (NONE, EAE» EIS» FISs or FRPUs default is NONE)? 


Arithmetic Hardware surrort is defined as follows: 

NONE ~- no arithmetic hardware is surrorted 

EAE - KELIA Extended Arithmetic Element is surrorted 

EIS - KELIE Extended Instruction Set is surrorted 

FIS - KELIF or KEVIIF Floating Instruction Set is surrorted 
FFU - FFFIilAy By or C Floating Point Unit is surrorted 


+ 


Ilo you want the transcendental functions? CY or Ne default is Y)? 


Y includes the transcendental functions: N does mot. 
The transcendental functions sare SQR,y SINs COS: ATNy 
LOG: LOGIO,s and EXF. 


Figure 1 The Dialogue Text 
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Tio you want the SUB command? (Y or Ns default is Y)? 


Y includes the SUB commands N does mot. SUE allows editing 
without retyring the entire BASIC statement. 


Tio you want the RESEQ command? ¢(Y or Ny default is Y)? 


Y includes the RESEQ commands N does not. RESEQ allows the 
reseaquencing of line mumbers in 3a BASIC rrogram. 


To you want longs error messages? (Y or N? default is Y)3 


Y includes longs error messages: N does. not. 

Longs messages ere several word exrlanations of an error 
condition. Short error messades are three character abbrevia- 
tions of the longs messades. 


Overlay structure ture (ly 2» 3» 4y or S? default is 1)? 


The overlay structures are described as follows: 

Tyre 1 - BASIC is not overlaid. 

Tyre 2 - The error messases are overlaid with a sedment of 
of the edit rhase,. 

Tyre 3 - The error messasde rhaser edit rhaser and the 
execute rhase ere overlaid. 

Tyre 4 - Similar to tyre 3 excert that the edit and execute 
Phases are overlaid internally. 

Tyre S - Similer to tyre 4 excert that the math rackasges the 
I/0 routines, are some other routines normally in the 
root sesment are overlaid. 

The higher the overlay structure ture numbers the less memory 

is reauired by BASIC. The saving in memory reauirements is made 
at the exrense of rerformance. Tyre 27 however,» nes very . 
hinimal effect on the rerformance of BASIC: with a substantial 
savind in memory if longs error messages are used. Flease see 
the documentation for more information. 


Figure 1 The Dialogue Text (Cont.) 


NOTE 


If you interrupt SUCNFG (with CTRL/C, 
for example) you must restart it from 
the very beginning by typing RUN SUCNFG. 


4.2.1 Overlay Types - The dialogue program lets you specify how your 
version of BASIC is to be overlaid. The listing reproduced in Figure 
1 summarizes the overlay types. Use overlay type 1 if conserving 
memory is not a concern on your system. Overlay type 2 is suitable 
for RKO5 and RKO6 systems where speed is more important than memory 
conservation. DIGITAL recommends type 2 for diskette-based systems. 
Overlay type 3 is suitable for RKO5 and RKO6 systems where memory 
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conservation is more important than _ speed. Use type 3 for 
diskette-based systems if memory is at a premium. Use overlay type 4 
if you must strictly conserve memory. BAS8K.SAV, the smaller version 
of BASIC supplied in the software kit, uses overlay type 5. It has 
many small overlay sections and, therefore, executes slowly. Use type 
5 only for 8K systems. 


4.2.2 Arithmetic Hardware Support - The versions of BASIC provided in 
the software kit do not support arithmetic hardware, Specify EAE if 
your system has the KE11-A or KE11-B Extended Arithmetic Element, Specify 
EIS to support the KEI11-E Extended Instruction Set on a PDP=11/35 
or PDP-11/40. Use EIS also for any PDP-11/34, 11/45, 11/50, 11/55, 
or 11/70 without the FPl1l Floating Point Unit. Specify FIS if your 
system has the KE11-F or KEV-11 Floating Instruction Set. Specify FPU 
to include support for the FP11 Floating Point Unit. Use FPU also for 
any PDP-11/60 even if it does not have the FP11-E Floating Point Unit. 


4.2.3 Foreground Execution - To link BASIC to execute in the 
foreground with either the FB or XM monitor, simply type an F in 
response to the dialogue program's "Background or Foreground?" prompt. 
To execute BASIC in the foreground, use the FRUN command with the /N 
option. You must use this option to ensure that your program has 
adequate memory space for foreground execution. Section 4.3 contains 
an example of linking BASIC and executing it in the foreground. 


4.2.4 Assembly Language Routines - The versions of BASIC provided in 
the software kit do not support the CALL statement for assembly 
language routines. To include CALL support, you must first add _ the 


names of your assembly language routines to BSCLI.MAC, as described in 
the RBASTC-11/RT-11 User's Guide Then assemble the three MAC files 


———~S we Seow RS ww woe ee —= -——= -e2—-S—=— 


together, supplying any file name for the resulting object file: 


«MACRO/ORJECTIMYCLI BSMAC+RSASM+BESCLI GED 


ERRORS DETECTEDS 4 


Next, assemble your assembly language routines. You can place more 
than one routine in an object file. Type a ¥ in response to the 
dialogue program's "Do you want CALL support?" prompt. The dialogue 
next requests the module names. On the first line, enter the name of 
the .OBJ file you specified in the MACRO assembly shown above. On the 
next lines, enter the names of the .OBJ files that contain your 
assembly language routines. On the last line, enter BSCLLB if your 
assembly language routines use any routines supplied by BASIC (see the 
BASIC-11/RT-11 User's Guide). Finally, type only the RETURN key to 
terminate the list of module names. The following example shows the 
CALL support section of the dialogue: 


Do you want CALL surrort? CY or Ne default is N)? Y@ED 


Enter module names (one rer line)? MYCLI@ED 
Module mame? 
Module name? 
Module mame? 
Module mame: 
Module mame? EBSCLLE 
Module mame: QED 
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4.2.5 Optional Features - You can link BASIC to add or delete support 
for any optional features. See the BASIC-11/RT-11 User's Guide for a 
discussion of the optional features. The text of the dialogue program 
(see Figure 1) lists the optional features you can add or delete at 
link time. 


4.3 Sample Dialogue 


The sample dialogue reproduced in Figure 2 shows how to link BASIC to 
run in the foreground. This example also requests a wide map listing 
(with /W), and adds support for EIS arithmetic hardware. The example 
then shows how to execute the indirect file and how to run the new 
version of BASIC in the foreground. 


-R_ BASIC GED 

BASIC-11/RT-11 VYO2-02 

OPTIONAL FUNCTIONS (ALL» NONE, OR INDIVIDUAL)? AGED 
REALLY 

RUN SUCNFG GED 

BRASIC-11/RT-11 VO2 Configuration Program 

Tyre "?lret:" after any rromrt for HELF. 

sSAY and .COM file mame (default is BASIC): MYBAS GED 
Do you want a mar? (CY or Ni default is N)! Y@ED 

»MAP mame (default is same as .SAV name)? /W@ED 


Rackdround or Foresdround ? (BR or F$ default is BB)! F@ED 


Do vou want FRINT USING? (Y or N¢$ default is Y)! Y@ED 


Ilo you want CALL surprort? (CY or N+ default is N)3 N@ED 


Single or Double rrecision math? (S or D3 default is S$): [GED 


Arithmetic hardware (NONE? EAEr EISr FISy or FPUs default is NONE)! EIS@ED 
Do you want the transcendental functions? (Y or N¢ default is Y)! Y@ED 

Yo you want the SUB command? (Y or Ny default is Y)$ Y@ED 

Do you want the RESEQ command? (Y or Ny default is Y)! YG@ED 


To you want longs error messases? (Y or N$ default is Y)? Y@ED 


Overlay structure ture (Ll, 27 3, 4% or 5) default is 1)3 


B 


The followings GLOBALS will be undefined. These 
errors may be ismored,. 
» ACS? «NRCS», armed «MSPS (from mo CALL). 


To create the RASIC that you have Just defined» 

“ype "RYE ret=" after BASIC rrints "REALLY". When the system 
yromets for ineuty ture "@MYRBAS<ret=" to link the mew BASIC. 
See the User’s Guide for anstructions on running 

BASIC in the Foresround. 


Figure 2 Sample Dialogue for Foreground 
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REATLY 
BYE @ED 


. @MYBAS GED 


eR LINK. 

KMYRAS s/W=/R21200// 

KXBSPTRIy RSFATs BSROD 
KRSRID ys RBSFRO 

XESCLIN 
*SU01IG,BSOTOLD.EIS»sBSOTIN.EIS 
*SUIOFPRsSUIOFO 

xXSUXIDy ESXOAr BSXOBs BSX1A»y BSX1B/Oi1 
*XESFER1 » BSCLSN 
XSUX2TO»BSX2/03 1 

XSUE LIN, BSEOsESEL»BSKEYS/021 
*BSCMF y BSSUB» BSRSQ 
xSUNTCM/0 21 

¥RSERR» BSERML/0O3 1 

Xx SUIMF » BSFUNC » SUOFT/032 

Ms / 

MLINK-W-Undefined slohals: 

+ UACS 

. NECS 

+ MSPS 

xOE 


»FRUN MYBAS/N! 3000. GED 


Fe | 
BASIC-11/RT-11 YO2-03 
OFTIONAL FUNCTIONS (ALL» NONE, OR INDIVIDUAL)? GRUB A GED 


READY 
1C¢ PRINT "WE ARE RUNNING IN FG NOW" GeD 
RUNNH @ED 


WE ARE RUNNING IN FG NOW 


REALLY 


kh ‘ 
UNLOAD FG 


* 


Figure 2 Sample Dialogue for Foreground (Cont.) 


4.4 Installation Instructions 
The BASIC-11/RT-11 software kit is distributed in the following forms: 
1 RKOS5 disk 
1 RKO6 disk 
1 RLO1 disk 
1 9-track magtape 
2 diskettes 


2 diskettes 
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When you receive the software kit, mount the distribution media 
(write-protected, if possible) and copy all the files onto an empty 
disk or tape. Then store the original distribution media in a safe 


place. Use your own copy of the software for the following 
installation procedure. 


If a version of BASIC provided in the software kit (BAS8K.SAV, 
BASICD.SAV, or BASIC.SAV) is suitable for your application and you do 
not need to modify it, simply transfer the appropriate file from your 
copy of the distribution medium to your system device. Use a command 
similar to this one: 


~COPY OX1°BASSK.SAV TRS 
You can now execute BASIC by typing: 
ok BASBK 


If a version of BASIC provided in the software kit is not suitable for 
your application, you must use the program SUCNFG to relink BASIC. If 
your system device is an RKU5 or RKU6 disk, transfer all the files 
from your copy of the distribution medium to your system device. Use 
a command similar to this one: 


-COFY/SETDATE RKIIK.* SY? GED 


for non-magtape distribution media, and 
»-COPY RKItk.* SY? @ED 
for magtape distribution medium. 


Run the dialogue program as described in Section 4.2. Then delete all 
the new files on your system device, except the new version of BASIC 
that you just created. Use this command to delete all the new files 
except for the new BASIC file: 


BASTC.SAYV 
+QELETESNEWF ILES/EACLUOE ET) 
filnemetsr | 


If your system device is a diskette or DECtape, your BASIC software 
kit consists of two volumes. The first volume contains all the .SAV, 
-BAS, .DAT, and .MAC files. The second volume contains all the .OBJ, 
-EAE, .EIS, .FIS, and .FPU files. 


NOTE 


If your system device is DECtape, follow 
this procedure for diskette-based 
systems, but substitute DT for DX in the 
examples that follow. 


First, mount the first volume in drive 1. Assign DK: to that unit, 
as follows: 
»sASSTIGN UXls 


Dn: 


Next, tun BASIC and SUCNFG, and answer the questions from the dialogue 
program. A sample run is reproduced in Figure 3. 
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+R RASIC GED 
RASIC-11/RT-11 VO2-02 
OF TIONAL FUNCTIONS (ALL.» NONE» OR INDIVIDUAL)? A GED 


READY 

RUN SUCNFG GED 

BASIC-11/RT-11 VO2 Confisuration Frosgram 

Tyre "Peret=" after any fromet for HELF. 

2SAV and .-COM file mame (default is BASIC)! BASSM GED 


lo you want a mar? (CY or Ne defsult is N)t N@ED 


Backsround or Foreground ? (BR or Fs default is B): &@ED 


fo vou want FRINT USING? (CY or Ne default is Y): N@EeD 


flo you want CALL surrort? (Y¥ or N}# default is N)! N@ED 


Single or Double rrecision math? (S or Ds default is G3 SGD 

Arithmetic hardware (NONE» EAE EIS» FIS» or FFUs default is NONE)! NONE @ED 
tio you want the transcendental fumetions? (CY or Ne default is Y: 

Do vou want the SUB command? (Y or Ny default is Y): 


No you want the RESEQ command? CY or Ne default is Y)! N@ED 


Do vou want long error messages? (Y or N3 default is ¥)! N@ED 


Overlay structure tyre (1 2, 3r 49 or Ss default is 123 2 @Er 


The following GLOBALS will be undefined. These 

errors may he ignored. 

»eFRUG (from mo FRINT USING>. 

~-UACEs « NRCHy and .«-«MSFS (from mo CALL). 

SQRT; SIN; COS; ATAN; ALOGIO; EXP: ane 

ALOG (from mo transcendental functions). 

+ SUBS (from mo SUE commsnd). 

++RES#$ (from ma RESEQ command). 

To create tne BASIC thet vou have Gust defined» 

tyre "BYE<ret>" after BASIC rrints “REALY". When the sustem 
eromrts for inruty tyre "@BASSMZret>" to link the new BASIC. 
You may tyre "RK BASSM“ret=" to run ite 


REALTY 


Figure 3 Sample Dialogue for Background 


When the dialogue program finishes, exit from BASIC and copy the new 
indirect file to your system device: 


BYE @ED . 
.COFY BASSN.COM 0X02 BASSM.COM GED 


Now remove the first volume from drive 1 and mount the second volume 
there. Execute the indirect file to link BASIC, as Figure 4 shows. 
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-@0X0:BASSM.COM 


*R LINK 
KERASSM=/EB31000// 
XESFTRS »BSFAT»yBSROS 
KXBSR1IS»BSFRON 

XESCLIN 

*SUO1I0»y BSOTOS 

XSUIOFPR:s SUTOFO,SUDTCM 
KESXOA»sESXOBRsHSX2Sy»BSXLA 
KESX1ByRBSFPRINy BSCLSN 
XBSEOs BSCMF 

XESSUBN» RSRSQN 
XSUEL1IDYBSELYBSKEYS/O071 
XESERR»s RSERMS/O2 1 
XSUIMF » BSFUNC sSUDFT/03 2 
K// 

PLINK-W-Undefined slopals? 
+ UACS 

++ SUERS 

+ RESS 

«+P RUS 

+ «NRCS 

«+ MSPS 

x7C 


Figure 4 Linking BASIC 


Next, copy the resulting .SAV (or .REL for foreground) file 
system device, and reassign DK: to DX0:. 


»COFY BASSM.SAV [X03 BASSMH. SAV GED 
-ASSIGN DXO!t DKS GED 

You can now execute your new version of BASIC: 
-K_BASSM GED 


BASIC-11/RT-11 VOR-O28 
OFTIONAL FUNCTIONS (ALL» NONE» OR INDIVITUALD? 


5.0 THE CONVERTING PROGRAM 


to your 


The BASIC software kit contains a converting program, SUCVT, that 
helps you modify programs written under BASIC/RT-11 VO1B so that they 


execute properly under BASIC-11/RT-11 V2. Use this program to 


modify 


all V0O1B BASIC programs that contain any of the following items: 


e Virtual arrays 
e User-defined functions that return strings 


@e REM statements that include a backslash (\) 
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e BIN or OCT functions that do not contain parentheses 
e Line numbers greater than 32767 

e DATA statements on multi-statement lines 

e CHRS or STRS functions 

@ RANDOMIZE statements 

e CALL statements 


See Section 2.0 of this document for a summary of how the items listed 
above have changed in V2 BASIC. 


5.1 Starting the Converting Program 


To use the converting program, first make sure that the following two 
programs, which are provided in the software kit, reside on your 
system device: 


1. SUCVT.BAS 
2. SUCVT1.BAS 

Then start BASIC. Respond to the READY prompt by typing: 
RUN SUCYT 


The converting program first requests the name of the file you need to 
convert. Enter the input file specification in the standard RT-11l 
format (dev:filnam.typ). Then the program requests the name to be 
assigned to the resulting converted program. Enter the output file 
specification. If you type only the RETURN key tor the output fiie 
name, the converting program examines the input file but does not 
create a converted output file. If you omit the file type in the 
input or output file specification, the converting program uses .BAS. 
The following is an example of the initial dialogue with the 
converting program: . 


RUN SUCYT 


INFUT FILE NAME? CUTEST @ED 
OUTFUT FILE NAME? CVOUT GED 


Next, the converting program requests the items you need to check for 
V2 BASIC compatibility (a complete list of the possible items is 
reproduced at the beginning of Section 5.0): 


WHICH FEATURES WOULT YOU LIKE TO CHECK (ALL» INDIVITUAL SELECTION)? 


To check all possible items for V2 BASIC compatibility, type an A. 
Typing only the RETURN key is equivalent to typing an A. If you type 
an A (or a RETURN), the converting program begins to examine the input 
file. 


If you type an I, the converting program lists each feature 
separately. If you need to examine a particular item, type a Y (or a 
RETURN). If you do not need to check a feature, type an N. The 
following is a sample dialogue: 
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WHICH FEATURES WOULD YOU LIKE TO CHECK (ALL, INDIVIDUAL SELECTION)? I GED 
VIRTUAL ARRAYS(Y OR N) ? Y GED 

NEF STATEMENTS(Y OR N) ? 

REM STATEMENTS(Y OR N) ? N@ED 

BIN ANI OCT USAGE(Y OR N) ? Y@ED 

STR$ AND CHRS USAGE(CY OR N) ? Y@ED 

DATA STATEMENTS(Y OR N) ? Y@ED 

RANDOMIZE STATEMENTS(Y OR N) ? N@ED 

CALL STATEMENTS(Y OR N) ? Y GED 


As a result of the dialogue shown above, the converting program would 
check all items except REM and RANDOMIZE statements. When you respond 
to the last line of the dialogue, the converting program begins’ to 
examine the input file. 


5.2 Interacting with the Converting Program 


As the converting program examines the input file, it searches for the 
items that you requested in the dialogue. When it finds an occurrence 
of a requested item, it prints the item (in most cases) and gives you 
an opportunity to modify a program line or add new program lines. 


When the converting program finds a virtual array OPEN statement, it 
prints the existing array name and requests a new array name. If you 
type just the RETURN key, the converting program repeats the request. 
If you type LIST, the converting program prints the program line that 
contains the OPEN statement, then repeats the request for a new array 
name. When you type a new virtual array name, the converting program 
replaces all occurrences of the existing name with the new name. Make 
sure that the new name you type is not used already as a variable in 
the program. After you enter a new virtual array name, the converting 
program requests a channel number for that array. If you type only 
the RETURN key, the converting program repeats the request. Make sure 
the channel number you enter is in the range 1 to 12 and is not used 
in any OPEN statement already in the program. 


When the converting program finds a DEF statement, it prints’ the 
existing function name and requests a new function name. If you type 
just the RETURN key, the converting program retains the existing 
function name and continues processing the input file. If you type 
LIST, the converting program prints the program line that contains the 
DEF statement, then repeats the request. When you type a new function 
name, the converting program replaces all occurrences of the existing 
name with the new name. Again, make sure that the new name you type 
is not used in any other DEF statement in the program. 


The converting program automatically corrects program lines’ that 
contain REM statements with a backslash (\) and those that use the BIN 
or OCT functions without parentheses. For REM statements, the 
converting program substitutes the words "BACK-SLASH" for the actual 
backslash character (\). For BIN and OCT functions, the converting 
program supplies the missing parentheses. The converting program does 
not request any information from you when it examines REM statements 
and BIN and OCT functions. 


The converting program always checks the line numbers in your program 
to see if there are line numbers’ greater than 32767. If the 
converting program detects such a line number, it prints the line 
identified by that line number and requests a new line number for it. 
Respond by typing a new line number; do not retype the entire 
statement on that line. Note that if you do not enter a new line 
number that is less than or equal to 32767, the program cannot execute 
under V2 BASIC. 
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When the converting program finds a CHRS$ or STRS function, a CALL or a 
RANDOMIZE statement, or a DATA statement that is on a multi-statement 
line and is not the last item, it first prints the appropriate warning 
message from the following list: a 


WARNING! FUNCTION CHR HAS CHANGED 

WARNING! FUNCTION STR HAS CHANGED 

CALL INTERFACE HAS CHANGED 

FUNCTION OF RANDOMIZE STATEMENT HAS CHANGED 
DATA STATEMENT NOT LAST 


Then the converting program prints the line that contains the function 
Or statement and requests anew line. If you type only the RETURN 
key, the converting program leaves the existing program line 
unchanged. If you type a new program line, the converting program 
deletes the original line and inserts the new line. The converting 
program continues to request new lines so that you can properly modify 
your VO1B program. Make sure that the new lines you type do not have 
the same line numbers as existing program lines, except for the line 
number of the deleted line. When you are finished, respond to the new 
line request by typing just the RETURN key. . 


When the converting program finishes examining the input file it asks 
if you need to convert another program: 


CONVERSION COMPLETE. 
ANOTHER CONVERSION? (Y OR N) ?F 


Type a Y (or the RETURN key) to restart the converting program. Type 
an N to terminate the program and return control to BASIC. 


5.3 Converting a Sample Program 

This section contains a sample V0O1B BASIC program, a reproduction of 
the converting program dialogue, and a listing of the resulting 
converted file. Read the dialogue carefully. Then compare the V0O1B 
BASIC program with the V2 BASIC version. 


Figure 5 is a listing of a V01B BASIC program called CVTEST.BAS. 
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100 
200 
300 
400 
300 
600 
700 
7350 
800 
900 
1000 
1100 
1200 
1250 
1300 
1400 
1450 
1500 
1600 
1700 
1800 
1900 
2000 
2100 
2200 
2300 
2400 
2500 
2600 
2800 
2900 
6000 


BASIC-11/RT-11 INSTALLATION GUIDE 


DEF FNV(S)=CHR$(S) 

DEF FNX(T)=TtHT"2 

OPEN ’TEST1.DAT’ AS FILE #6 

OPEN ‘TEST2.DAT’ FOR OUTFPUT(4) AS FILE #4 
OPEN ‘TEST3.DAT’ FOR OUTPUT AS FILE VF1(25) 
OPEN ‘TEST4.DAT’ FOR OUTPUT(10) AS FILE VF22¢25) 
OPEN ’TESTS.DAT’ FOR OUTFUT AS FILE VFS$(64) 
OPEN ’TESTS.DAT’ AS FILE VF6$(6)=16 

REM TEST PROGRAM FOR V1B 

REM CONTAINS A \ FOLLOWEDBYMORETEXT 

DATA ‘NOT’ »’AT’s ‘END’ 9 “OF ’»’A’y“LINE’\GO TO 1100 
K=0CT( “7077 ) 

PRINT K 

PRINT KtVF1(4) 

K=0CT’ 7077’ 

FRINT K 

PRINT KtVF2(3) 

K=BIN( “1010107 ) 

FRINT K 

K=BIN‘’101010/ 

PRINT K 

K=BIN’10101°+12 

FRINT K 

FP$=’GTY’ &FNV(S) 

PRINT FNX(9) 

PRINT FNVC6) »FNXCVF1C7)) 

LET VFS(S)=’NOWIS THE ‘’&STRSCFNX(1)) 
RANDOMIZE 

CALL “HYFOT’ (GrKrZ) 

CLOSE VFi 

CLOSE VFS 
Oo END 


Figure 5 V01B BASIC Program 


Figure 6 is a sample dialogue with the converting program. Note 


all 


the 


that 


possible features are to be checked for V2 _ BASIC 
compatibility. 
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RUN SUCUT GED 


INPUT FILE NAME? CVTEST GED 
OUTPUT FILE NAME? CYOUT GED 


WHICH FEATURES WOULD 


YOU LIKE TO CHECK (ALL» 


VIRTUAL ARRAYS(Y OR N) ? 


DEF STATEMENTS(Y OR ND 7? ¥ GED 


REM STATEMENTS’ (Y OR N) ? Y@ED 
BIN AND OCT USAGE(Y OR N) ? YG@ED 


STR$ ANI CHR$ USAGE(Y OR N) 7? 
DATA STATEMENTS(Y OR ND) ? Y@ED 
RANDOMIZE STATEMENTS(Y OR N) ? Y@ED 
CALL STATEMENTS(Y OR N) ? Y@ED 
FUNCTION NAME? FNY 

NEW NAME! ? FNUSGED 

FUNCTION NAME! FNX 


NEW NAME: ? LIST GED 
200 DEF FNX(T)=T+T°2 
NEW NAMES ? GED 

VIRTUAL ARRAY NAME VF1i 


NEW NAME 


? C GED 


CHANNEL NUMBER 7? i1@ED 
VIRTUAL ARRAY NAME VF2% 


NEW NAME 


? C% RED 


CHANNEL NUMBER ? 2 GED 
VIRTUAL ARRAY NAME VFSS 


NEW NAME 


? C$ GED 


CHANNEL NUMBER ? 3 GED 
VIRTUAL ARRAY NAME VF6é$ 


NEW NAME 


CHANNEL NUMBER ? 


? C1$@ED 
5 RED 


LINE NUMBER GREATER THAN MAX 


OLD. LINE: 


NEW LINE 
WARNING! 
OLD LINE 
NEW LINE 


60000 END 
NUMBERi? 32000 GED 
FUNCTION CHRS HAS CHANGED. 
; 100 DEF FNV$ (S)=CHRS(S) 


= FUEL 


DATA STATEMENT NOT LAST 


OLD LINE 


NEW. LINE. 


NEW LINE 
NEW LINE 
WARNING ! 
OLD) LINE 
NEW LINE 
FUNCTION 
OLD LINE 
NEW LINE 
NEW LINE 


$ 1000 DATA ‘NOT’»’AT’>» 
? 1000 GOTO 1100@ED | 
? 1010 DATA ‘“NOT‘’s’AT’» 
? GED 

UNCTION STR% HAS CHANGED. 
2400 LET C$(5)=’NOWIS THE 
? GED 

F RANDOMIZE STATEMENT HAS CHANGED 
2500 RANDOMIZE 


? 50 RANDOMIZE GED 
? GED 


“END’ »’OF’s’A’s’LINE’\GO TO 1100 


‘END’ » ‘OF’ A‘ » “LINE ’ GED 


“&STRSCFNX(1)) 


oe 06 oo & ve of ‘Tl oe 08 04 © 


CALL INTERFACE HAS CHANGED 


OLD LINE 
NEW LINE 


$ 2600 CALL 
3 PRED 


“HYFOT’ (GeKyZ) 


CONVERSION COMPLETE. 
ANOTHER CONVERSION? (CY OR N) ? N@ED 


READY 


Figure 7 is the listing of the 


Figure 6 Converting Program Dialogue 


resulting converted program, 


CVOUT.BAS: 
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OLD. CVOUT GED 


REALY 
LIST GED 


cVOuUT 17-AUG-77 11337319 


50 RANDOMIZE 

100 DEF FNV$(S)=CHRS$(S) 

200 DEF FNX(T)=T+T"2 

300 OPEN ’TEST1.DAT’ AS FILE #6 

400 OPEN ‘TEST2.DAT’ FOR OUTFUT AS FILE #4y% FILESIZE 4 
300 OFEN ‘TEST3.DAT’ FOR OUTPUT AS FILE #1 \ DIM #1»C(25) 
600 OPEN ‘TEST4.DAT’ FOR OUTPUT AS FILE #2, FILESIZE 10 \ DIM #2°C%(025) 
700 OPEN ‘TESTS.DAT’ FOR OUTPUT AS FILE #3 \ DIM #3°C%(64)=32 
750 OPEN ’TEST4.DAT’ AS FILE #5 \ DIM #5°C1$(6)=16 

800 REM TEST FROGRAM FOR V1E 

900 REM CONTAINS A “BACK-SLASH" FOLLOWEDBYMORETEXT 
1000 GO TO 1100 

1010 DATA ’NOT’s’AT’s END’ » OF’ A’ ® “LINE ’ 

1100 K=0CT( ‘7077 ) 

1200 FRINT K 

1250 PRINT KtC(4) 

1300 K=0CT(‘°7077 >) 

1400 PRINT K 

1450 PRINT K+C4(¢3) 

1500 K=BIN(’1010107) 

1600 PRINT K 

1700 K=BIN(’1010107 ) 

1800 PRINT K 

1900 K=BIN(‘10101’)+12 

2000 FRINT K 

2100 P$=’GTY’ &FNYVS(S) 

2200 PRINT FNX(?) 

2300 FRINT FNV$(6) sFNX(CC7)) 

2400 LET C$(5)=’NOWIS THE ’&STRS(FNX(1)) 

2600 CALL ’HYFOT’ (GrKrZ) 

2800 CLOSE 1 

2900 CLOSE 3 

32000 END 


READY 


Figure 7 V2 BASIC Program 


5.4 Compiling the Converting Program 


If you need to use the converting program frequently, compile the 
program so that it executes more efficiently. See Figure 8 for the 
commands to do this. 
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OLD SUCVT 


REALY 

COMPILE 
REALY 

OLD SUCVTI 
REALY 

COMPILE 
REALY 


Figure 8 Compiling the Converting Program 
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The following are trademarks of Digital Equipment Corporation: 
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DECUS EDUSYSTEM PHA 

UNIBUS FLIP CHIP RSTS 
COMPUTER LABS FOCAL RSX 
COMTEX INDAC TYPESET-8 
DDT LAB-8 TYPESET-10 
DECCOMM DECSYSTEM-20 TYPESET-11 
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conservation is more important than _ speed. Use type 3 for 
diskette-based systems if memory is at a premium. Use overlay type 4 
if -you must strictly conserve memory. BAS8K.SAV, the smaller version 
of BASIC supplied in the software kit, uses overlay.type 5. It has 
Iany small overlay sections and, therefore, executes slowly. Use type 
5 only for 8K systems. 


4.2.2 Arithmetic Hardware Support - The versions of BASIC provided in 
the software kit do not support special arithmetic hardware. Specify 
EAE if your system has the KEI11-A or KE11-B Extended Arithmetic 
Element. Specify EIS to support the KE11-E Extended Instruction Set. 
Use EIS also for any PDP 11/34, 11/45, 11/50, 11/55, or 11/70 without 
the FP11 Floating Point Unit. Specify FIS if your system has the 
KE11-F or KEV-11 Floating Instruction Set. Specify FPU to include 
Support for the FP11l Fioating Point Unit. Use FPU also for any PDP 
11/60 without the FP11-E Floating Point Unit. 


4.2.3 Foreground Execution - You must link BASIC to execute in the 
foreground with either the FB or XM monitor. To do this, simply type 
an F in response to the dialogue program's "Background or Foreground?" 
prompt. To execute BASIC in the foreground, use the FRUN command with 
the /N option. Section 4.3 contains an example of linking BASIC and 
executing it in the foreground. 


4.2.4 Assembly Language Routines - The versions of BASIC provided in. 
the software kit do not support the CALL statement for assembly 
language routines. To include CALL support, you must first add the 
names of your assembly language routines to BSCLI.MAC, as described in 
the BASIC-11/RT-11 User's Guide. Then assemble the three .MAC files 
together, supplying any file name for the resulting object file: 


+MACRO/OBRJECTIMYCLI BSMAC+BSASM+ESCLI 
ERRORS DETECTED: 9O 


Next, assemble your assembly language routines. You can place more 
than one routine in an object file. Type a Y in response to the 
dialogue program's "Do you want CALL support?" prompt. The dialogue 
next requests the module names. On the first line, enter the name of 
the .OBJ file you specified in the MACRO assembly shown above. On the 
next lines, enter the names of the .OBJ files that contain your 
assembly language routines. On the last line, enter BSCLLB if your 
assembly language routines use any routines supplied by BASIC (see the 
BASIC-11/RT-11 User's Guide). Finally, type only the RETURN key to 
terminate the list of module names. The following example shows the 
CALL support section of the dialogue: 


lo you want CALL surrort? (CY or N default is N)? Y@ED 


Enter module mames (one rer line)? MYCLI@ED 
Module name! MOD1@ED 

Module mame? MOD2 GED 

Module name? MOD3@eD 

Module mame! MOD4@ED 

Module name? BRSCLLEC@ED 

Module mame: (ETD 
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4.2.5 Optional Features ~- You can link BASIC to add or delete support 
for any optional features. See the BASIC-11/RT-11 User's Guide for a 
discussion of the optional features. The text of the dialogue program 
(see Figure 1) lists the optional features you can add or delete at. 
link time. 


4.3 Sample Dialogue 


The sample dialogue reproduced in Figure 2 shows how to link BASIC to 
run in the foreground. This example also requests a wide map listing 
(with /W), and adds support for EIS arithmetic hardware. The example 
then shows how to execute the indirect file and how to run the new 
version of BASIC in the foreground. 


-R_ BASIC GED 
BASIC-11/RT-11 VYO2-02 
OPTIONAL FUNCTIONS (ALL» NONEr OR INDIVIDUAL)? A GED 


READY 

RUN SUCNFG GED 

BASIC-11/RT-11 VO2 Confisuration FProsgram 

Tyre "?Peret=" after any eromrt for HELP. 

sSAV and .COM file name (default is BASIC)! MYBAS GED 
Bo you want a mar? (Y or N3 default is N)? 

eMAF mame (default is same as .SAV mame)! /W@&ED 


Backsdround or Foresround ? (BR or Fe default is B)? F@ED 


Do vou want FRINT USING? (Y or N3 default is Y)! Y@ED 


Do vou want CALL surrort? (CY or N+ default is N)? N@GED 


Sintle or Double rrecision math? (S or Ile default is S$)! DI GED 


Arithmetic hardware (NONE, EAE, EIS, FIS: or FFU? default is NONE)? EIS@ED 
Do you want the transcendental functions? (Y or Ni default is Y)3 

Do you want the SUB command? (Y or Nr default is Y)3 

Do you want the RESEQ command? (Y or Nv default is Y)! Y@ED 


Yo vou want longs error messades? (Y or N3 default is Y)! Y@ED 


Overlay structure ture (1 2 3y 4 or Ss default is 1)3 


e 


The followings GLOBALS will tbe undefined. These 
@rrors may be ismored,. 
> UACS: .«..NRCSe and .«.MSPS (from mo CALL). 


To create the BASIC that vou have just defined» 

‘Sure "BYE<rets" after BASIC rrints “"READY'. When the system 
Prompts for ineuty, ture "@MYBAS<ret?" to link the mew BASIC. 
See the User’s Guide for instructions on running 

BASIC in the Forestround. 


Figure 2 Sample Dialogue for Foreground 
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READY 
FRYE GED 


-@MYBAS 


«Rk LINK 
XMYERAS» /W=/RI1200// 
KBSPTRD» BSPAT ss BSRON 
*xXBSR1IDs BSPRO 

*ESCLIN 
*SUOLIUsBSOTOD.EISsBSOTI2. EIS 
xSULOPRsSUTOPO 

*SUXIC+ BSXOAr BSXOBs BSX1A*BSX1IB/0i1 
XBSFR1»BSCLSN 
*KSUX2ID,BSX2/031 
XSUELIU,BSEO*sESE1,sBSKEYS/0O31 
*<BSCMF » BSSUBs BSRSQ 
MSUDITCM/OT 1 

*KBSERR » BSERML/031 

xSUIMF » BSFUNC y SUDFP T/03 2 

KS f 

“LINK-W-Undefined slobals? 

» UACS 

« -NECS 

+ «MSPS 

xeC 


»FRUN MYBAS/N!3000.QED 

Fe 

BASIC-11/RT-i1 YO2-03 

OF TIONAL FUNCTIONS (ALL: NONE> OR INDIVIDUAL)? GiRvP A GED 


REALY _ 
10 PRINT "WE ARE RUNNING IN FG NOW" GED 
RUNNH @ED 

WE ARE RUNNING IN FG NOW 


REATIY 
BYE GED 


RB 
UNLOAL FG 


* 


Figure 2 Sample Dialogue for Foreground (Cont.) 


4.4 Installation Instructions 


The BASIC-11/RT-11 software kit is distributed in the following forms: 
1 RKO5 disk 
1 RKO6 disk 
l magtape (7- or 9~-track) 
2 diskettes 


2 DECtapes 
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When you receive the software kit, mount the distribution media 
(write-protected, if possible) and copy all the files onto an empty 
disk or tape. Then store the original distribution media in a safe 
place. Use your own copy of the software for the following 
installation procedure. 


If a version of BASIC provided in the software kit (BAS8K.SAV, 
BASICD.SAV, or BASIC.SAV) is suitable for your application and you do 
not need to modify it, simply transfer the appropriate file from your 
copy of the distribution medium to your system device. Use a command 
Similar to this one: 


«COPY DXLtBASSK.SAV_ Ik t GED 
You can now execute BASIC by typing: 
+R BASBK GED 


If a version of BASIC provided in the software kit is not suitable for 
your application, you must use the program SUCNFG to relink BASIC. If 
your system device is an RKU5 or RKO6 disk, transfer all the files 
from your copy of the distribution medium to your system device. Use 
a command similar to this one: 


»COPY RKitk.* DRY @ED 


Run the dialogue program as described in Section 4.2. Then delete all 
the new files on your system device, except the new version of BASIC 
that you just created. Use this command to delete all the new files 
except for the new BASIC file: 


| RASIC. SAV 
-DELETE/NEWFILES/EXCLUDE RET 
filnametsyr | _ 


If your system device is a diskette or DECtape, your BASIC’ software 
kit consists of two volumes. The first volume contains all the .SAV, 
-BAS, .DAT, and .MAC files. The second volume contains all the’ .OBJ, 
-EAE, .EIS, .FIS, and .FPU files. 


NOTE 
If your system device is DECtape, follow 
this procedure for diskette-based 


systems, but substitute DT for DX in the 
examples that follow. 


First, mount the first volume in drive 1. Assign DK: to that unit, 
as follows: 


*ASSIGN DX1: DK3 GED 


Next, run BASIC and SUCNFG, and answer the questions from the dialogue 
program. A sample run is reproduced in Figure 3. 
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BASIC-11/RT-11 Installation Guide 


Order No. DEC-11-LIBTA-A-DN1 
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the release of BASIC-11/RT-11l Version 2 for 
the RLO1 disk. 
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